home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu108.dms / pu108.adf / Vertex / Docs / Chapters / 1-Add < prev    next >
Text File  |  1992-09-04  |  10KB  |  315 lines
  1. ====================================================================
  2. The Add Menu                   Vertex                            1-1
  3.  
  4.  
  5.  
  6.     THE ADD MENU:
  7.  
  8.     Function            FastKey                              Page
  9.     ==================  ===================================  ====
  10.     Add Shapes          A-S                                   1-2
  11.     Add Grid            A-G                                   1-3
  12.     Add Duplicate       A-D                                   1-4
  13.     Add Basic Shapes    A-B                                   1-5
  14.     Add Vertex Precise  A-V                                   1-7
  15.     Add Edge            A-E                                   1-8
  16.     Add Face            A-F                                   1-8
  17.  
  18.  
  19. To add anything to Vertex, you must either read an object from disk,
  20. or create a new object within the program. Object reading is covered
  21. in its own section, later in this manual.
  22.  
  23. The Add menu is where you can create new objects. Available are
  24. functins to create lathes, polygons, grids, simple shapes such as
  25. rings and spheres, and individual vertices. Also included, are
  26. functions to add specific edges and faces to previously created
  27. objects. 
  28.  
  29.  
  30. ====================================================================
  31. Add Menu: Shapes               Vertex                            1-2
  32.  
  33.  
  34.  
  35. Function:   Add Shapes
  36. FastKey:    A-S
  37.  
  38. Description:
  39.  
  40. This is the new polygon creator. Should be a vast improvement over
  41. the older tool.
  42.  
  43. This function changes the main view into the shape definer. The
  44. buttons on the left of the display will change:
  45.  
  46.     POINTS      Add points, connected by edges. Auto close on points.
  47.     LINES       Click and drag. See below for resolution.
  48.     BOX         Click and drag out a rectangle.
  49.     ARCS        Click the CENTER point, drag out a line, press and
  50.                 hold to define the arc (up to 180 degrees in either
  51.                 direction.)
  52.     EDIT        Lets you edit your shape while in the Shape Creator.
  53.     SET RES     Adjust the resolution for lines and arcs, above.
  54.     
  55.     GRID        Toggle the grid on or off.
  56.     SNAP        Toggle the snap-to-grid. Grid must be on to work.
  57.     GRID RES    Set the grid resolution on X and Y
  58.     OVERLAY     Draw all previous objects, from the front view,
  59.                 behind your new shape and the grid.
  60.     
  61.     EXIT        Exit this tool.
  62.  
  63. The first function, POINTS, should operate just like the older
  64. Add-Polygon tool, but the shape will auto close when you re-click on
  65. a point. To start a new shape, simple re-select this option.
  66.  
  67. Lines and Arcs can have a settable resolution. The arcs may take some
  68. getting used to - Just remember to first click at the CENTER of the
  69. arc, then draw out the radius, then click and hold to sweep out the
  70. arc itself. You can change the resolution by adjust Set-Res.
  71.  
  72. Edit will let you re-shape your objects immediately. There may be
  73. screen residue after moving a few points - to get rid of it, just
  74. click on EDIT again.
  75.  
  76. Grid will toggle the state of the grid. Snap has been seperated from
  77. grid per user request.
  78.  
  79. You may choose exit at any time.
  80.  
  81.  
  82. ====================================================================
  83. Add Menu: Grid                Vertex                        Page 1-3
  84.  
  85.  
  86.  
  87. Function:   Add Grid
  88. Fast Key:   A-G
  89.  
  90. Description:
  91.  
  92. Grids are similar to graph paper. You can define the width and height
  93. of the grid, and the resolution.
  94.  
  95. When this function is chosen a requestor appears, asking for the
  96. following information:
  97.  
  98.     GRIDX:  This is the size, in units, of the grid width.
  99.     GRIDY:  This is the size, in units, of the grid height.
  100.     RESX:   This is the number of divisions to use for the width.
  101.     RESY:   This is the number of divisions to use for the height.
  102.     NAME:   The name of the new object.
  103.  
  104. Grids are nice for applying curves to and using the multiply function
  105. with. Be careful, however, as grids can take up large amounts of 
  106. storage space quickly.
  107.  
  108. Add grid now places the grid on the X,Y axis. Previous versions placed
  109. the grid on the X,Z axis. 
  110.  
  111.  
  112. ====================================================================
  113. Add Menu: Duplicate           Vertex                        Page 1-4
  114.  
  115.  
  116.  
  117. Function:   Add Duplicate
  118. FastKey:    A-D
  119.  
  120. Description:
  121.  
  122. You can duplicate any object or set of selected vertices. You are 
  123. presented with a requestor asking for:
  124.  
  125.     DISTX:  This is the amount to move the new object on the X axis
  126.     DISTY:  This is the amount to move the new object on the Y axis
  127.     DISTZ:  This is the amount to move the new object on the Z axis
  128.     ROTX:   Amount of rotation around the X axis
  129.     ROTY:   Amount of rotation around the Y axis
  130.     ROTZ:   Amount of rotation around the Z axis
  131.     SCAL X: Amount of scaling on the X axis
  132.     SCAL Y: Amount of scaling on the Y axis
  133.     SCAL Z: Amount of scaling on the Z axis
  134.     STEPS   The number of diplicates to create. This value is divided
  135.             into the DIST, ROT and SCAL amounts you enter.
  136.  
  137. This requester is getting a little crowded. You can now move, scale 
  138. and rotate the duplicate parts, and set the number of steps to take 
  139. in the duplication.
  140.  
  141. All selected vertices, and any associated edges and faces will be
  142. duplicated.
  143.  
  144.  
  145. ====================================================================
  146. Add Menu: Basic Shapes        Vertex                        Page 1-5
  147.  
  148.  
  149.  
  150. Function:   Add Basic Shapes
  151. FastKey:    A-B
  152.  
  153.     Cube            A-B-C
  154.     Pointed Star    A-B-P
  155.     Ring            A-B-R
  156.     Sphere          A-B-S
  157.     Tube            A-B-T
  158.     Cone            A-B-N
  159.     Disk            A-B-D
  160.     Circle          A-B-C
  161.     Arc             A-B-A
  162.     File            A-B-F
  163.  
  164. Cube
  165.  
  166.     When this function is selected a requestor appears asking for the
  167.     length, with an height of the cube to be created, and its name.
  168.     
  169. Pointed Star
  170.  
  171.     You are prompted with a reqiestor asking for the number of Points,
  172.     the total diameter, and the name of the object.
  173.     
  174. Ring
  175.  
  176.     This function brings up a requestor asking for a number of values:
  177.     
  178.     Radius1     The actual diameter of ring sections
  179.     Radius2     The total diameter of the finished ring
  180.     Points      The number of points to create ring sections with
  181.     Res         The total number of divisions to make in the entire
  182.                 ring
  183.     Name        The name of the object.
  184.    
  185. Sphere
  186.    
  187.     The add basic sphere function askes for the diameter, points and
  188.     res of the sphere.
  189.     
  190.     Radius      The total width of the finished sphere
  191.     Points      How many points to make the side of the sphere
  192.     Res         The total divisions to create the sphere
  193.  
  194.  
  195. ====================================================================
  196. Add Menu: Basic Shapes        Vertex                        Page 1-6
  197.  
  198.  
  199. Tube
  200.  
  201.     You enter the the radius, height and resolution.
  202.  
  203. Cone
  204.  
  205.     Similar to tube, but creates a solid base object.
  206.  
  207. Disk
  208.  
  209.     Enter radius and resolution.
  210.  
  211. Arc
  212.     Lets you easily add arcs with any radius,resolution and degrees.
  213.  
  214. Circle
  215.     Enter the radius and the resolution.
  216.  
  217. File
  218.  
  219.     I've included this so we can easily define a set of objects and
  220.     have them available without hunting through directories. To use
  221.     this feature you must take care of some pre-requisites:
  222.     
  223.         1.  The ENV: device must be available. If you do not have an
  224.             ENV: device, I'd suggest adding this line to your
  225.             startup-sequence:
  226.         
  227.             assign ENV: ram:
  228.         
  229.         2.  There should be an entry on the ENV: device called PRIMS.
  230.             You can create this file thus:
  231.             
  232.             setenv PRIMS dh0:3d/objects/primitives/
  233.             
  234.             Or use any directory you wish. Again, I'd suggest you put
  235.             this line in your startup-sequence.
  236.      
  237.     If you've set everything up properly, you can access this
  238.     directory anytime you choose this menu option. After Double
  239.     clicking the file you wish to load, a requester will appear
  240.     asking for 3 scaling values, X,Y and Z. This lets you easily
  241.     scale the objects at load time.
  242.     
  243.     I've had at least one request for this type of feature. If you think
  244.     it's worthless, then don't bother with it. However, if you do
  245.     something like set-design and you need a set of basic shapes to
  246.     be used over and over, you just save them here and have them
  247.     available quickly and easily. The directory is cached, meaning
  248.     when you go to save your actual file, the original directory will
  249.     still be in the file requester.
  250.  
  251.  
  252. ====================================================================
  253. Add Menu: Vertex Precise      Vertex                        Page 1-7
  254.  
  255.  
  256.  
  257. Function:   Add Vertex Precise
  258. FastKey:    A-V
  259.  
  260. Description:
  261.  
  262. You can add vertices at precise positions with this function. You are
  263. presented with a requestor asking for:
  264.  
  265.     POSX:   The X coordinate of the vertex
  266.     POSY:   The Y coordinate of the vertex
  267.     POSZ:   The Z coordinate of the vertex
  268.  
  269. The name of this vertex will be the name of the last vertex. If you
  270. wish to enter large numbers of vertices in this manner, you may want to
  271. use Arexx instead.
  272.  
  273.  
  274. ====================================================================
  275. Add Menu: Edge                Vertex                        Page 1-8
  276.  
  277.  
  278.  
  279. Function:   Add Edge
  280. FastKey:    A-E
  281.  
  282. Description:
  283.  
  284. This function lets you add edges by clicking on 2 vertices.
  285. You can continue adding edges until you press the right mouse button.
  286.  
  287. If you create an edge over an existing edge, it will be deleted by
  288. Vertex.
  289.  
  290.  
  291.  
  292. ====================================================================
  293. Add Menu: Add Face
  294.  
  295.  
  296. Function:   Add Face
  297. FastKey:    A-F
  298.  
  299. Description:
  300.  
  301. This function lets you add faces by consecutively selecting 3 vertices.
  302. You can continue adding faces until you press the right mouse button
  303. or the space bar.
  304.  
  305. If you create an edge over an existing edge, it will be deleted by
  306. Vertex. 
  307.  
  308. This function is the only good way to fill concave polygons. If you
  309. create a polygon you may try filling it with Planar-Fill under
  310. modify. If this does not yield correct results, you may either add the
  311. faces by hand, or use another software which has the ability to fill
  312. concave polygons.
  313.  
  314.  
  315.